URLDecode

Type

function

Summary

Returns the decoded form of a URL that was encoded for posting to an HTTP server.

Syntax

the URLDecode of <formString>

URLDecode(<formString>)

Description

Use the URLDecode function to decode a URL that has been sent by another system.

When the URLDecode function encounters a percent sign (%), it treats the next two characters as hexadecimal digits. (If one of the characters is not a hexadecimal digit, it's treated as a zero.) The number is converted to its character equivalent, using the character set currently in use.

note

Non-ASCII characters, such as Unicode, that appear in the URL string to be decoded will have been encoded as UTF-8 (as per standard convention), requiring the use of the textDecode function after urlDecode. For example, the following code:

    local tEncodedText
    put \"%D1%81%D0%BA%D0%BE%D1%80%D0%BE%D1%81%D1%88%D0%B8%D0\" & \
          \"%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C\" into tCodedText
    put textDecode(urlDecode(tEncodedText),\"UTF-8\")

produces the word "скоросшиватель".

Parameters

Name	Type	Description
formString	string

Examples

URLDecode("A+B%2F1+2") -- returns "A B/1 2"

put URLDecode(field "Test URL") after URLToCheck

Related

function: decompress, macToISO, arrayDecode, charToNum, baseConvert, textDecode

glossary: decode, return, sign, encode, character set, hexadecimal, server, function

keyword: URL, characters, character, http

property: httpHeaders

command: post

control structure: function

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile